From: Stefano Stabellini Date: Thu, 8 May 2014 15:43:08 +0000 (+0100) Subject: clarify SHUTDOWN_suspend additional argument X-Git-Tag: archive/raspbian/4.8.0-1+rpi1~1^2~5028 X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/success//%22http:/www.example.com/cgi/success/?a=commitdiff_plain;h=bfc2e6e9423da679a35f33a9c488060748d94844;p=xen.git clarify SHUTDOWN_suspend additional argument Clarify the behaviour of SCHEDOP_shutdown: PV x86 guests need to pass a third argument, that is unused on HVM and ARM guests. Signed-off-by: Stefano Stabellini Acked-by: Ian Campbell --- diff --git a/xen/include/public/sched.h b/xen/include/public/sched.h index a30b11d96a..4000ac99dd 100644 --- a/xen/include/public/sched.h +++ b/xen/include/public/sched.h @@ -76,9 +76,10 @@ * Halt execution of this domain (all VCPUs) and notify the system controller. * @arg == pointer to sched_shutdown_t structure. * - * If the sched_shutdown_t reason is SHUTDOWN_suspend then this - * hypercall takes an additional extra argument which should be the - * MFN of the guest's start_info_t. + * If the sched_shutdown_t reason is SHUTDOWN_suspend then + * x86 PV guests must also set RDX (EDX for 32-bit guests) to the MFN + * of the guest's start info page. RDX/EDX is the third hypercall + * argument. * * In addition, which reason is SHUTDOWN_suspend this hypercall * returns 1 if suspend was cancelled or the domain was merely